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2. API for Ul 
2.1. EPGChannelLineup 

Description Call this function to get a list of brief show information for a given range of AOL :zzzzs\ 
numbers and tune frame. The returned show amy ts sorted in die order of AOL caacnei 
number and show beginning ome. 
Prototype Boolean EPGChanneiLmeuo(const hnejjp & sane, snow_,nfo * const smfo, rt • 
const sorder mt itength, query _error 4 err); 
Parameter* # siine: IN PARAMETER. This structure specifies rime grid* and the range of \Ql 
channel numbers. The data structure is defined as: 
struct line up 
{ 

time j umejgnd^start; 
time J time jjnd^end; 
mt aoi_channetjd w start; 
int aoi j:hannet jd^end; 

• Lnfo; OUT PARAMETER, sinfo is an amy of type show jnfo. 
struct show Jnfo 

tnt aoLchann«*jnjmber, 
char cai»Jetter(9]; 
time J begin Jime; 
short duration; 
unsigned char catjndex; 
unsigned cftar sub.cat jndex; 
char short Jitiel221; 
long referencejiumber; 

^ ^ rttrr OAOiwrm. ft stores the order of shows sorted in AOL channel 

' s a ££ K^°n ±. 

5^5352 Lb.»ta«*« ft. «put tatfL Otfa*^ FALSE , 

struct qu«fy.«rror 

^ int •n > _«x»; 
chw •cr.mtgllOO]; 

) 

RtturnV** ™*f£^ prtpm abta for d*a l«din« 

mm j urn 

long refw«fic«_numB«r. 
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} 

descnpaoQ, etc. The data smjcture is defined u ^"*3ory. 
struct show description 

{ 

char rest jrfjitie{ 100]; 
char shortjiescnption(64]; 
char descnption(801]; 
char category 3]; 
char subcategory {13]; 
short year produced; 
float stars; 
boo! rejoin; 
bool live; 

bod ciosed_caption; 
bool stereo; 
char tvj-ating(13]; 
char mpaa ratmg(5]; 

} 

♦ err OUT PARAMETER. 
Return Value TRUE: Success 

FALSE: Fails to prepare tables for data loading 

.3. EPGFilttr 

Description To get a list of shows having specified category- index and subcategory-index. Category- 
index and subcategory- index are numbers between 0 to 15. 
Prototype Boolean EP<3Fiiter<show.catjnfb &*cat showjnfo • const sinfo, mt • const sorder, 
int itength, queiy_error 4 err); 
Parameters • scat IN PARAMETER. The data struct showiest Jnfo is defined u 
struct show catjnfo 
{ 

short catjndex; 
' v - short sufc.cstjndex; 

- * • * urns J begin jime; 

unsigned cher updown Jtag; 

Above data structure specifies category index, subcategory index, beginning tune of a 
search, aad forward or backward search flag. Updown Jag»1 means forward search, 0 
means backward search. The search is limited among the shows of the same day as the 
specified beginning time. 

• sMb: OUT PARAMETER* sinte is an array of type showjnfo. 

• sorder OUT PARAMETER. It stores the order of showi sorted in AOL channel 
o^ber and time. For example, sWb(gorder(0n is the first show, smfo(sorder(l]] the 

• IN OUT PARAMETER. As an m parameter, iengtt is the dimension of sinfo 
sorder, provided the number is less than the input length. Otherwise, faloc is 

• ^?a£^ 

zero erT^code means something is wrong in the caiL 
Return Value TRUE: Success 
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1. API for Data Loader 

1.1. TsipCallback::StartLoading 

QeecrlptJon StartLoading is responsible for preparing database tables for the data loading. Therefore 
chis function must be called before data loading. After data loidmg is doae, SrdLoac.rg 
funcuon shall be called. 
Prototype Boolean StartLoacingQ 
Parameter* None 
Raturn Value TRUE: Success 

FALSE; Fails to prepare tables for data loading 

1.2. TsipCaliback:: StartSlp 

Qeecription StartSip marks the beginning of the data loading of i show iniormaaon packet. \ show 

uiformauon packet contains 4-hour show data for one channel. SndSip uideicates zzi of 
che data loading of one packet 
Prototype Boolean StartSipO 
Parameter* None 
Return Value TRUE; Success 

FALSE; Fails to prepare tables for data loading ^ ~ ' 

1.3. TsipCaliback:: WriteSip 

Deeciiption WhteSip uwra one or couple of show data into database tables. 

Prototype Boolean WnteSip(const SipHeader ishdr, const Showwfo *psi, mt length) 
Parameters • shdr PARAMETER. SipHeader contains common data shared by show daa stored 
in the array Sbowuifo. 



struct 
TUNECHAN { 

unsigned char type; 



unsigned short minor, 
unsigned short major, 



// bO-2: 0;OTA 1 :cabie 2:sateiitte 3-7: reserved 
// b3: digital 64: dual A/B cable trunk b5-7: rsvd 
// up to 10 bits of digital minor channel 
// up to 10 bits of digital major channel, or analog 
// channel 



stiuctSl0Meadar 



{ 



short channel Ms // unique Gemstar channel lO 
TUNECHAN tunej^channe*;// see struct cie^iton below 

%2dS» //YYVYMMOOnuUtermuiittd 

uns - // on 4 how intwvais (0, 4, 8, 1 2, 1 8. 20) 



p«fcINPAltANflETER.ShOWirtoi4d«fia«du 

struct Show* to 



{ 



char 
char 

char 



char 
char 



Mmtvn- II short tttta, as disptaysd on ghd titles 
w - - //thtcompiatashowtrta 

// null terminated 
begin Jmeti 51; 
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/ Show starting time with format of YYYYMMOOHHMi 

7 null terminated, MM takes a value of 01 12; 

<v 00 taKes a value of 01... .31; hh takes 

'/ a value of 00... .23; Ml takes a value from 00 to 59, 

char end Jime(t 5]; // as aoove. used for performance suroosa 

mt duration;// m minutes 

char category(l 3]; // category name, null terminated 

unsigned cnar cat jndex; 

char subcategory^ 3]; 7 sub<ategory name, null terminated 

unsigned char sub^catjndex; 

short year ^produced; ~ d four digits, e.g. 1998. For searcn ourccse 
float stars; // 0,0.5,1 ,1 5,2,. ,.,4 5,5 for searcn ourccse 

booi rejw, 
Oooi live; 

oooi ciosed.captjon; 
000* stereo; 

Char TV rating(13]; // ,f TVMA.fVOLVS # TVY-LV, null terminated 
char mpaa.rattnglS]; U wr, *X' null terminated 

}' * - " 

osi u the pointer of the amy Showmfo psifjength]. 
. length: IN PARAMETER tsngth tails how many show records a the amy p». 

1 ■*• 0 ™&t b " «i n i2L - - * ■ — <-»■• 

Prototype VotdSndSip<) 
Param«t«rt Now 
RttumVtlu* Void 

1 .5. TsipCallbackr. EndLoadlng ^ D tt Lowiet ^ endLoading to avoke » 

Prototype VoW SndloadingO 
Pinmtttrt Now 
R«tumVilu« Void 
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3* API for AOL Channel Mapping 
3.1. AOLMapGat 

Deecription This function returns an amy of aOL Channel Mapping data to the caller AOL Chinset 
Mapping describes the mapping among AOL Channel Call letter, aOL Category, md 
Channel Id. 

Prototype Boolean AOLMapGet(aol j:hanne*_map * const mtnfo, 
length, query .error & err) 
Parameters • mtnfo: OUT PARAMETER. The pointer minfo points to an amy of 
aoi ^.channel jnap. The struct aoi_channe* jnap is defined a 
struct dol channel map 



mt * const sorcer ,nt 



{ 



• sordat OUT PARAMETER. It stores the order of AOL Channel Mappings sorted -n 
AOL channel number. 

« length- IN OUT PARAMETER. As an in parameter. length is the dimension of m*nfa 
and sorder , as an out parameter, it is the actual number of AOL Channel Mappings 
stored m minfo and sorder, provided the number is leas than the input length. 
Otherwise, FALSE is returned and en is populated wuh messages. 

. em OUT P ARAMETER. It holds error mfonnaaon if error occurs. Nonzero 
encode means something wrong uuhe calL 

TRUE: Success t j . 

FALSE: Fails to prepare tables for data loading 



char cail Jettert9]; 
unsigned" short channel jd; 
unsigned short aoi,channei; 
unsigned short aoi_cat 



Return Value 



3.2. AOLMtpSat w^ticn by calling this taction. Inside of AOLMapSet, Lt 

Oaacnptlon C^*^^ 

The struct aol j**™*-" 1 * 0 * def5acd u 
struct aot j*iann«iim«p 



Prototype 
Parameter* 



{ 



charcaHJ«tt*t9V. 

unsignod short aoLcrmnn*: 
unsigned short aoi.cat; 



R»tumVih» 



4 



FIG. 10B 



Perimeters • 



minfo: OUT PARAMETER, minfo is an array of ao< Tim auiCe The "aa s-- 
ao^minijuide is defined as: ~ * 

struct 



{ 



} 



char name{1 5]; //AOL Category 

unsigned short criannei; //AOL Channel number 
unsigned short offline; '/ AOL Channel number starts at 
unsigned short start: // AOL Channel segment starts at 
unsigned short end; //AOL Channel segment ends at 
unsigned short dup^start; //Local Channel starts at 



Return Value 



• sorder: OUT PARAMETER. The order of AOL Mini Guides by AOL channel 
number. 

• length: EN OUT PARAMETER. As an in parameter, length tells the dimension of 
mtnfo and sorder, as an out parameter, it is the actual Dumber of AOL Muu Guides 
stored m mtnfo and sorder, provided the number is less dun the input length. 
Otherwise, FALSE is returned 

• err: OUT PARAMETER. Non«zero err_code means something wrong in the cail. 
TRUE; Success 

FALSE: Fails to prepare tables for data loading 



3.4. AOLMiniGuid«3«t 

Description Caller can set AOL Mini Guides by calling this funcnon. Inside of AOLMmiGciideSet «ch_ 
element of the array mtnfo is checked against die records in database. If a category exists ux 
the database, then update the row by the new data from minfo; if a category does*' t exist u 
the database, then insert a new row into the database. 

BodMfi AOUVtiniGu*d«S«t(*tf jriini.jutde * const minfo ( tnt 4length,duwY.error & 



Prototype 
Parameter* 



Rev 



err) 

• ffltafe* IN PARAMETER. The pointer minfo poms to an any of toljTwii jutf* 
. length: IN PARAMETER, It a the aetuil number of AOL Mini Guides stored a 

• BrnOUT PARAMETFB . Noa-zero err.code tnesss something wrong in the ctlL 
TRUE: Succeu " 

FALSE: FmIi to prep«K table, • C « ^ t- loedinf 
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GtmSUr AAOU'S i 
datadtcodtr* ' 
data ioadtr , 



AOL TV Data management Moduie 



Filee 



Uoz. 





row h««c«f 


row body 



























char nam* [30] ; 
char f^nama [3 01 ; 
char c^cace CIS] ; 
long t_ro*; 
long a_row; 
long narrow; 
short hdr_len; 
short rov_ttart; 
short row_len; 
3 ho r t row_hdr_l en ; 
short r cv j:dy _1 en ; 
short row hdr_3tart; 



• Name: Table r.ame 

• C_date: When the cable is created, m the form "YYYVMMDDHHMISS' 

• F^iame: the file wbere the data is stored 

• T jow Total number of initialized row* 

• Narrow Next available row ui for insertion 

• Hdi Jen: length of the header 

• Row^start: where the data (row) suit {*hdr Jen); 

• Row Jen: the length of a row 

• Row Jidr Jen: length of the row header 

• Row J)dy Jen: the length of the row-body 

• Row Jidr_staxt: Where the row-header sum 

Struct row_hdr 
long row^td 

long next_availaJ5l«_row; 
char usag«; 

} 

• Row id: row id of the row. Increased by one each ha* 

• Nexravaxiable.fow: row id of the next available row for assertion 

• usage: '>T means available;^ means used 
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